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1. INTRODUCTION 

The AT&T UNIX* PC Enhirccd TCP/IP WIN/3B LAN 
Interface for the ATAT UNIX PC (WINV3B LAN) brings to 
the UNIX PC a complete networking environment. In addition 
to the primary administrative task of installation^ there are 
many other tasks that need to be performed from time to time. 

WIN/3B LAN has two user interfaces through which you can 
perform these administrative tasks: the standard UNIX 
System V shell, and the UNIX user agent or window interface. 

LI PURPOSE OF THIS GUIDE 

The purpose of this Guide is two-fold: to educate you on the 
elements of WIN/3B LAN and to orient you to go(^ network 
administration practices. The emphasis is on building an 
understanding of what your network is and how to operate it, 
rather than on a recipe approach to network problem solving. 

1.1.1 Prerequisites 

This Guide assumes familiarity with administration of the 
UNIX^ operating system on the UNIX PC. It also assumes some 
familiarity with WIN/3B LAN at the user level. It is 
recommended that before reading this Guide, you acquaint 
yourself with these other WIN/3B LAN documents: 

WIN/3B LAN User*! Guide 

This Guide discusses ftp, telnet and other user 

1. WIN is a trademark of The WoUoo{oaf Groap, lac. 

2. UNIX is a registered frademark of ATAT. 
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commands. It contains an introduction to 
networking and a glossary. 

W1N/3B LAN Programmer*! Reference ftfanoal 

This Manual is the complete reference for WIN/3B 
LAN. Special attention should be focused on 
intro<4), 'Introduction to Networking Facilities', 
and Section IM, 'Network Maintenance and 
Operation Commands'. 

1.L2 Coarentloni 

A number of conventions are employed throughout this Guide. 

>^'here samples of interactive cessions are given, user input is 
shown in boldface while system responses are shown in plain 
print. 

Filenames, commands, and option names are shown in italics 
unless they are part of a chapter or section heading or sample 
session. In headings they mny appear partially or completely 
capitalized when iv practice they arc not. Filenames are 
always shown with their pathnames. 

The user’s home directory is referenced by a ' (tilde). The 
pathname ‘Ifilename indicates that filename is in that user’s 
home directory. 

The first occurrence of a new term is enclosed in quotation 
marks unless it is used in a chapter or section heading. 
Subsequent references are not so marked. 

l.U Contents 

This Guide is organized into eight chapters and three 
appendices. Chapters 1 and 2 provide background information 
on the nature of the tasks WIN/3B LAN performs and on 
WrN/3B LAN structure. 

Chapter 3 discusses user tools provided by WIN/3B LAN, 
explaining how they operate and giving examples of their use. 


Chapter 4 discusses the network databases. These files contain 
information critical to the operation cf WIT4/3B LAN. The 
purpose and format of each is discussed 

Chapter 5 discusses the automated procedure for installing 
wrN/3B LAN software. Using this procedure with the 
WIN/3B LAN menu interface makes the installation process 
simple and straightforward. 

Chapter 6 discusses network configuration and maintenance 
procedures. The configuration and maintenance operations are 
located in a single menu for quick access and easy execution. 

Chapter 7 discusses the procedure to deinstall software on the 
WIN/3B LAN, This procedure is simplified through use cf a 
single menu option. 

Chapter 8 contains several sections of ./IN/3B LAN error 
messages along with brief explanations of their possible causes. 

Appendix A points you to the documentation for hardv/are 
installation. 

Appendix B contains three examples of bow to go about 
resolving network problems. 

Appendix C lists some good sources of networking 
information. 

1.2 NETWORKING WITH WIN/3B LAN 

This chapter provides context information for the rest of the 
Guide: a brief introduction to some of the basic networking 
concepts embodied in WIN/3B LAN. If you arc already 
familiar with networking or WIN/3B LAN in particular, you 
may wish to skip to the next chapter. 
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U.l CompoCer Networks: Layers, Protocols, and Interfaces 

Interconnecting computers allows an organization to share 
data and computing resources. As the number of computers 
within an organization increases, the value of interconnecting 
them increases. Computers that are interconnected to form a 
network arc called "Tiosts'. 

Networking is made possible through the interaction of 
hierarchically organized 'layers' of functionality. The layer 
furthest from the user is the physical; the others are all 
software layers. Each succeeding layer provides more and 
more sophisticated services to the layer directly above it until 
finally the user is presented with the most sophisticated layer, 
called the 'application' layer, through which he readily and 
without any networking expertise may make use of the 
facilities provided by the underlying layers. This U analogous 
to the way in which UNIX shell commands provide a user with 
readily accessible operating system services without requiring 
any knowledge of how those services are provided. 

Each layer carries out a specific subset of related functions. 
These functions taken together implement a 'protocol', which 
is a set of rules governing the actions within a given layer. The 
protocol implemented in a layer is specific to that layer, and 
for that reason a layer on one host can communicate only with 
the corresponding layer on another host, ealled a 'peer*. This 
characteristic of protocols, that they communicate only 
horizontally, is called 'peer-to-peer' communication. In some 
c.nr.cs a layer contains more than one protocol, but the 
principle of peer-to-peer communication still pertains. 

But communication requires all layers working' together. 
When communication takes place, data is passed vertically 
across layer boundaries according to rules known to the two 
interacting layers. These rules comprise the 'interface* 
between the two layers. Layers interact vertically only with 
adjacent layers. 


A user entering a networking command causes the passage of 
data down through the succeeding layers until it eventually 
makes its way to the hardware or 'physical' layer. On its way 
down it gets successively packaged by the different layers, each 
protocol usually adding a 'header' or 'leader' to what it 
receives. This is referred to as the 'packetizing' of the data; 
the data packages arc called 'packets'. When a packet comes 
out the hardware at the other end, it is passed up through the 
succeeding layers, each layer stripping off the header attached 
by the corresponding layer on the source host and acting on 
the packet according to the Information contained in the 
header. 

WIN/3B LAN supports a set of UJ5. Department of Defense 
(DoD) standard protocols collectively known as TCP/IP 
transmission Control Protocol/Intemet Protocol) and thus 
enables AT&T UNIX PC computers to interconnect with other 
computers that support these protocols. Wollongong and other 
companies supply TCP/IP for many UNIX computers; UNIX 
PC computers can interconnect with these as well as with 
other UNIX PC computers by way of WIN/3B LAN. 

For more information on hierarchical network architecture, 
see the references listed in Appendix C. 

1.2.2 Ethernet Physical Transport Medlom 

Ethernet, originally developed by the Xerox Corporation in 
1972, but since adopted as a standard by many companies, is 
currently one of the physical network media available for 
UNIX PC computers. The physical components of an Ethernet 
network arc cable, transceivers, and a network interface 
board. The Ethernet cable is the actual transmission medium. 
The transceiver taps onto the Ethernet cable and is connected 
to the interface board by another length of cable. The 
Ethernet interface board resides in the backplane of the 
computer and enables it to formulate outgoing data and 
interpret incoming data according to established mica. 
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Installatiofi of these phj'sicai components enable* a computer 
to communicate with other computers over the Ethernet cable. 
This physical configuration is shown in Figure 


to other hosts 


to other hosts 


Figure 1*1. Ethernet Physical Configuration 


1.2 J Ethernet Addrcisiiis 

Once the physical means for communication ure in place, a 
further concept is required. This is the notion of 'addressing*. 
Addressing is simply the assignment of a unique designation to 
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each host on a network. WIN/3B LAN supports both 
'broadcast' and 'point-to-point' addr'-^sing Broadcast 
addressing enables a host to transmit a packet to all hosts on 
its network. Point-to-point addressing enables a best to 
transmit a packet to a specific host. 

Every Ethernet interlace board has a unique address, called an 
Ethernet address, assigned to it at the time of its manufacture; 
being interface board specific, it is a 'physical' address. This 
address contains six bytes. The first three bytes are a unique 
manufacturer identifier assigned tc the manufacturer by the 
Xerox Corporation. The remaining three bytes arc determined 
by the manufacturer, who must ensure that these three byte* 
arc unique for each interface board it manufacture*. This part 
of the address is analogous to a serial number. 

1.2.4 Internetworking 

The interconnection of networks extends the concept of 
computing n; .o.ifCC shering a step beyond simple networking. 
It is useful iu ibtay organixation that wants to gain access to 
computers that arc already on existing networks. A common 
scenario is an organization wanting to interconnect their local 
area network with the AT’^ANEtC 

U.4.1 Gateways 

A 'gateway* i:i the physical mechanism for interconnecting 
networks. A host computer acting as a gateway has a hardware 
connection to each of the networks being connected, as 
illustrated in Figure 1-2. 


3. The network of the Department of Defense Advanced Research Projects Agency 
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F igure 1'2. A Gateway Between Two Networks 


Gateways provide access to hosts on other networks even 
though they arc not directly connected to your network. For 
instance, gateways can connect your UNLX PC host to hosts on 
other private local area networks (LANs), or to public 
networks such as ARPANET. 

\J1AJ1 Rooting 

But a physical gateway is not enough to enable Internetwork 
(often abbreviated to 'Internet') communication. Hosts on an 
Internet also require information on how to get packets to one 
another: they require 'routing' information. TTiis is nothing 
more than a description of how to get from one host to 
another on an Internet. Routing is the software concept that 
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complements the hardware concept of a gateway; it enables 
hosts to utilize the hardware capability provided by the 
gateway. Currently, each host on a TCP/IP Internet maintains 
its own routing information. 

1 J.4J Internet Addressing 

Routing through a gateway implies the concept of 'Internet 
addressing*. An Internet address b the designation by which a 
host is known to other hosts, whether on its own or a 
connected network. Internet addresses are independent of the 
physical addresses (e.g. Ethernet addresses) in force within 
interconnected networks, and are therefore called 'logical' 
addresses. In WIN/3B LAN. for example, the Internet address 
of a host is independent of its Ethernet address, and therefore 
will not change if the physical transmission medium changes: 
if the Ethernet interface board on a host fails and is replaced 
with another; its Ethernet address changes, but its Internet 
address remains the same. 

All Internet addresses contain four bytes, but what each of 
these bytes signifies varies with the Internet address class it 
represents. There are three classes of Internet address: A, Q 
and C. All hosts on a given network share the same Internet 
address type. The type chosen depends on. and thence 
determines, the way the network is organized. 

Class A addressing reflects the simplest network organization. 
It allows a collection of hosts to be divided among 128 
networks. This is by far the most common network 
organization in use today. If more than 128 networks are 
needed, then class B or C addresses must be used. In Class A 
addressing, the first byte of the Internet Address identifies the 
host's network- The last three bytes identify the individual 
host. 

Class B allows only 64 networks, but each of these networks 
can be subdivided into 512 subnetworks. Converting a class A 


9 








WIN/3B L 


ADMfMSTRA'^ i 


ADMlWfSTW ATOR s GUIDK 


WIN/3B LAN 


network into class B requires rcstructurinj? the network into 
64 networks each containing up to 512 subnetworks. In Class 
B addressing, the first byte of the Internet address identifies 
the host’s network; the second byte identifies the host’s 
subnetwork. The last two b>'tes identify the individual host. 

Class C allows only 32 networks, but each of these may be 
subdivided into 512 subnets. Each subnetwork may be further 
subdivided into 512 subhosts. Converting a class A network 
into class C requires a major redesign of your network 
topology. This network class is rarely, if ever, used today. In 
Class C addressing, the first byte of the Intemet address 
identifies the host’s network; the second byte identifies the 
host's subnetwork; and the third byte identifies the host’s local 
area network (LAN). Finally, the last byte identifies the 
individual host. 

There arc many factors to consider .vhen determining which 
network organization and Intemet address class to implement; 
this subject is beyond the scope of this Guide. One salient 
point, however, is that while the organization chosen may 
reflect the actual, physical layout of the Interact, it may also 
reflect a purely logical view without reference to physical 
layout. For instance, one of the more sophisticated 
organizations, class D or C. may be implemented in order to 
facilitate a closer tracking of network usage for billing 
purposes. For more detailed information on the formulation 
of Interact addresses, see Section inet(3N) in the WIN/3B LAN 
Programmer’s Reference Manoal. 


2. WIN/3B LAN SOFTWARE COMPOLTNTS 


WIN/3B LAN adds new servicea to the UNIX operating system 
on your UNIX PC. Some arc provided at the user level, while 
others arc incorporated into and pro\adcd by the UNIX 
kernel. 


2.1 USER LEVEL 


The user level components of WIN/3B LAN fall into three 
categories: programs or commands, software function libraries, 
and databases. Virtually all the networking needs of general 
users, networking programmers, and network administrators 
can be satisfied by the components provided at this level. 
These components arc illustrated by Figure 2-L 
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Figure 2*1. User Level WIN/3B LAN Components 
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2.1.1 XJtfit and AdmlnlstratlTe Prognunj 

The application programs arc of two types; commands 
available for general use and those whose use is rertricted to 
the superuser. 

The general use commands provide users with the ability to 
login to remote hosts, to transfer files between networked 
hosts, and to get various data about the current status of the 
network and the hosts accessible through it. A facility for 
sending electronic mail is also provided. These commands are 
discussed in depth in the WUM/3B LAN User Golds and in 
Section 1 of the W1N/3B LAN Prognunmer’s Reference 
Manoal. Points of administrative interest regarding them are 
discussed in the chapter on 'GENERAL USER SERVICES'. 

The restricted use commands perform a variety of 
administrative functions. Some used for maintaining network 
information tables kept in the UNIX kernel. These commands 
are discussed in detail in Section IM of the W1N/3B LAN 
Piogrammers’s Reference Manual, as well as in the chapters on 
•GENERAL USER SERVICES' and 'CONHCURATION 
AND MAINTENANCE'. 

2.1.2 Network Databases 

In order to function, the* network needs not only hardware 
and software but also information. For example, the network 
needs to know the names, addresses, and services available on 
each host. Some of this information is maintained in tables 
within kernel portions of WIN/3B LAN, but much of It is kept 
in files that can be modified only by the superuser. Setting up 
and maintaining these files are important network 
administration duties. These files are discussed in Section 5 of 
the WIN/3B LAN Programmer’s Reference Manoal, as well as 
in the chapter on "NETWORK DATABASES'. Procedures 
for setting up and maintaining these files are discussed in the 


chapters on 'SOFTWARE INSTALLAnON' and 
'CONnCURATION AND MAINTENANCE' 

2A3 Programming Interface Libraries 

Two user level programming in'erfacc libraries are available 
through which networking services can be invoked. These are 
the Socket Compatability Interface (SCI) library and the 
Transport Level Interface (TLI) library. They provide 
mutually exclusive interfaces to the kernel level network 
services. All networking application programs rely on one or 
the other of these libraries. 

The SCI library provides a family of functions based on the 
concept of a 'socket.' This library provides an interface that is 
compatible with the networking system call interface available 
in the A2 BSD version of the UNIX operating system. This 
library is defined in detail in Section 3W of the WIN/3B LAN 
Programmer*! Reference Manual. 

The TLI library is an implementation of a family of functions 
newly defined by AT&T. These functions will eventually 
become a standard part of UNIX and will be fully supported 
by AT&T. This library is defined in detail in Section 3T of 
the W1N/3B LAN rrogrammer’a Reference Mjmoal. 

2.2 KERNEL LEVEL 

WIN/3B LAN kernel level services arc provided by a UNIX 
special file or loadable device driver. Device drivers arc the 
software engines in UNIX whose job it is to manage i/o. 
Ordinarily, each device driver is tailored to one particular 
kind of hardware device, the capabilities of which it manages 
and makes accessible to the operating system and so to the 
user. Drivers normally contain entry points that allow a user 
to open, read from, write to, send UNIX ioctls to, and close 
the device. They also contain interrupt handlers through which 
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they interact with the underlying hardware. 

Some drivers arc not associated with hardware. These are 
referred to as pseudo dc\icc drivers, A pseudo device driver 
simulates the action of a hardware driver and is sometimes 
used as a multiplexer to other device drivcT-^. 

The drivers discussed above and below contained within 

the single loadable device driver that is loaded at boot time. 


2J!.l Network Pseudo Driver 

This pseudo driver is the network protocol engine, 
encapsulating support for the TCP/IP protocol family and 
providing the services advertised by both programming 
interface libraries (SCI and TLI). It accepts data from the 
user level, packages it according to the chosen protocols, and 
passes it on to another driver. Co'^vcrAcIy. it accepts data 
from that other driver, unpackages it according to the 
appropriate protocols, and passes it up to the user level. 

This driver, /dev/nef, is composed of the following, starting 
with what is closest to the user level and working down: 

A. Transport Endpoint Interface (TEI); 

D. Transmission Control Protocol (TCP) or User Datagram 
Protocol (UDP); 

C. Internet Protocol (IP) and Internet Control Message 
Protocol (ICMP). 

This driver consists of an interface and two protocol layers. In 
addition to the TEI there is also an interface Wtween the 
TCP/UDP protocol layer and the IP/ICMP layer, but since it is 
private to these layers and is invisible to users and 
administrators alike, it receives no further mention here. The 
structure of Idevinet is shown in Figure 2-2. 


Transport 

Endpoint 

Interface 


TCP 

UDP 

IP/ICMP 


USER LEVEL 


KERNEL LEVEL 


Figure 2-2- Network Pseudo Driver Structure 


2.2.1.1 Transport Endpoint Interface (TEI) 

The Transport Endpoint Interface is a body of kernel level 
entry points built around the concept of a 'transport 
endpoint". These entry points correspond to the functions in 
the SCI and TLI libraries. They make the services of the 
TCP/UDP protocol layer available to those libraries. 

A transport endpoint identifies an instantiation of the opened 
network pseudo device. When a given instantiation is created 
and opened, an identifier is returned to the calling user level 
process. This identifier is then referenced in order to carry 
out any further communication between the user level process 
and the TCP/UDP protocol layer. 
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The SCI and TLI libraries have different views and 
implementations of transport endpoints, although the facilities 
provided are essentially the same. In the terminology of the 
SCI library transport endpoints arc sockets and in that of the 
TTI library they are simply standard UNIX file descriptor*. 

2.2.1.2 Transmlslon Control Protocol (TCP) 

TCP and UDP provide users with different types of service, 
but reside in the same protocol layer. The primary 
responsibility of TCP is to provide user programs, through the 
TEl, with 'virtual circuits'. A virtual circuit is a reliable data 
pathway established between the TCP layers of two 
communicating hosts. Reliability means that the data sent out 
on a virtual circuit always arrives exactly as it was sent. TCP 
guarantees this reliable, sequential data transfer. 

2.2.U User Datagram Protocol (UDP) 

UDP provides an unreliable datagram service to user programs. 
A datagram is approximately the same thing as a packet. UDP 
docs not enforce reliability, that is, it docs not provide a 
sender with any indication that a sent packet was successfully 
received. UDP also docs not guarantee that data will be 
received in the same order in which it was sent. Reliability 
and data sequencing arc the specialty of TCP. 

2 J.1.4 IntemeC Protocol (IP) and Internet Message Control 
Protocol (ICMP) 

IP is responsible for routing datagrams to their destination 
Internet addresses. Like UDP, it is a datagram service which 
docs not guarantee reliable or sequenced data transfers. In 
fact it is the IP datagram service which UDP makes available 
to the user level through the TCI. 


ICMP is an adjunct of IP used to control the behavior of IP It 
informs IP of errors such as bad routes and also communicates 
general control information such as that necessary for data 
flow control. 

2.2.2 Ethernet Driver 

The Ethernet driver is responsible for managing the Ethernet 
interface board. It receives outgoing packets from IP and 
passes them to the interface board, which puts them out on 
the net. Conversely, incoming packets are taken off the 
interface board and passed upstream to IP. 

2.2 J Terminal Psuedo Driver 

The pty, or psuedo iry, is a pseudo terminal driver that enables 
an interactive user to login to a remote host. This is known as 
a network virtual terminal (NVT) capability. In UNIX each 
user is connected to a shell via a tty driver. The tty driver 
handles all terminal control information like XON, XOFF, and 
tabs. The pty driver performs the same function when a user 
talks to a remote shell. All terminal control information is 
passed from the local host across the network to the remote 
pty. The pty processes the information and the remote shell 
never knows it is not connected to a real tty. There are eight 
ptys on each host. Hence each system can handle a maximum 
of eight remote logins. 

2.2.4 Loopback Pseodo Driver 

This pseudo driver utilizes networking facilities without ever 
actually sending a packet out onto the network. Instead, 
communication is set up with the local host as though it were 
a remote host: the communication is 'looped back'. This 
driver is useful for testing networking facilities. 
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3. GENERAL USER SERVICES 

General user service* typically involve the cooperative 
interaction of two separate processes, one on the local host 
?jid one on the remote. The local host process is referred to 
as a 'client' because in initiating the interaction it is seeking 
the services of a corresponding process on s remote host. The 
remote host process is referred to as a 'server* because its 
purpose is to serve the needs of the client process. This 
cooperative interaction, called the 'client/server model', is the 
paradigm for the operation of most general user service*. A 
corollary of this ii that, for most general user services, if an 
appropriate daemon is not running on the chosen host the 
service is unavailable. 

The normal life cycle of a client process starts when a user 
enters one of the networking commands. The client process 
then sends a request for service to the appropriate process on 
the host specified by the user. If the request is honored, a 
connection is established, or 'opened', between the local client 
and remote server processes. The user transacts the remainder 
of his or her business over this open connection. Finally, the 
user enters the appropriate termination sequence, the 
connection is closed, and the client process dies. A server 
starts its life cycle as a background process started by the 
superuser. In this initial state the server is called a 'daemon*. 
The daemon listens' at a known address for incoming service 
requests. When it receives a request, it establishes a 
connection with the requesting client, spawns a child process, 
and goes back to listening for more incoming requests. The 
child, the server, inherits the connection established by the 
parent and handles all further client burliness for the duration 
of the session. When the termination sequence, stnt by the 
client is received by the server, it closes the connection and 
dies. 

One caveat on the above distinction drawn between daemon 
and server: in common parlance the distinction is often 
ignored, and the terms 'daemon* and 'server* arc used 
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interchangeably. You should be able to tell from the contest 
which process is meant. 

3.1 FTP AND FTPD 

The program that implements the DoD File Transfer Protocol 
is called ftp. It enables a user to transfer files between the 
local and a remote host. 

When establishing a connection with ftp, a rcmoic host can be 
specified by its Interne: address, its c^ficial 'hostname' or by 
aa 'alias'. If the official hostname or an alias is supplied.//p 
searches the file /etc/hosts to find the corresnonding Internet 
address. Using the Internet address, it makes a c'^nncction 
with the remote ftp daemon, called ftpd. The first step of the 
ftpd server is to validate the user making the request. It docs 
so according to three rules: 

1. The user’s username must be in the standaid UNIX file 
fetcipasswd. When this check is passed, the ujcr is 
prompted for the password before any file transfer 
operations can be performed. If there is no password 
associated with the login name, the user must still type 
something other than a carriage return when prompted for 
a password, to gain access to the remote host. 

2. If the username ir< 'ftp* and an account is present in 
/etclpasswdf the user is allowed to login by specifying any 
password. Since anyone can login under 'ftp', it is wise to 
restrict the access privileges of this account. 

3. The username must not appear in the file ietctftpwser. If it 
does, access is denied. 

3J TFTPANDTFTPD 

The DoD Trivial File Transfer Protocol user program, called 
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tftp, is simpler than ftp but less vcrs".ti!e. 

tftp differs from ftp in a number of ways. One is that it laclu 
any login facility. Another is that while ftp uses TCP, tftp 
uses UDP. For this reason tftp is considered an unreliable 
method of transferring files. 

When tftp is invoked, it makes a connection with the remote 
tftpd daemon, tftp does not validate users and therefore can 
only be used to transfer publicly readable files. 

33 TELNET AND TELNETD 

The telnet program implements the DoD network virtual 
terminal protocol TELNET. It enables a user to login to a 
remote host from a local host, provided the user has an 
account on the remote host. It appears then to the user as 
though his or her terminal is directly attached to the remote 
host. Telnet can be invoked in either the input or the 
command mode. In the input mode, telnet is invisible: the 
user is logged into the remote host and goes about Us or her 
business. 

In the command mode, the user enters commands to telnet. 
One of these commands is the negotiate command. It can be 
used to negotiate the setting of various optional qualities of 
the opened connection. This command supports four actions 
through which negotiation proceeds: do, dont, wtll^ and wont. 
(Note that dont and wont do not contain apostrophes.) When 
do or dont are used to initiate a negotiation, the client 
requests that the remote server set or unset the option 
specified. The remote server then responds that it either will 
or wont. A negotiation started with will or wont announces to 
the server that the client is willing or unwilling to set a 
specified option. The remote server will respond with do or 
dont. When the remote server makes the appropriate 
response, the negotiation is complete and the option is set or 
not, accordingly. 


Six options can be negotiated: 

binary This option sets transmission to binary By default, 
telnet transmits with seven bits, using the eighth bit 
for parity checking. Some applications require the 
full eight bits. 

status This command causes all options currently set on 
the server to be displayed. 

echo This option is used to set charactei echoing by 
either the client or the server. 

sga Suppress go ahead. Half duplex systems need a *go 
ahead' signal to begin transmitting once the other 
system is finished. This option is unnecessary for 
full duplex systems. 

tm Timing mark. This forces the server to flush all 
data in its queue and to send a timing mark. This 
command is useful if you have a connection that 
you believe is hung. 

exopl Extended options list. This list is not currently 
implemented but is included in the TELNET 
specification in anticipation of additional options. 

Negotiation examples are shown below. The blank line after 
each successful response indicates how telnet command mode is 
exited after just one correct entry. 

tclnet> options 

Will show option processing. 

telnet > negotiate 

negotiate> do status 

SENT lAC DO STATUS 

RCVD lAC WILL STATUS 

SENT lAC SB STATUS SEND lAC SE 

STATUS IS: 
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WILL BINARY 
WILL ECHO 

tclnct> n 

negotiate> dont echo 
SENT lAC DONT ECHO 
RCVD lAC WONT ECHO 


3.4 RLOGIN AND RLOGIND 

The rlogin command, like telnet^ provides a way to login to a 
remote host. It differs from telnet in that it lacks any external 
standard by »^hich the correctness of its implementation can be 
judged and it was designed and implemented specifically for 
UNIX systems 

rlogind is the daemon for rlogin. When the server ts spawned it 
first attempts to validate and automatically log the user in by 
checking tnamed !etc!hostsjequiv. This file contains a 
list of host* wiih which the current host has user accounts in 
common. If the incoming request is from a so called 
'equivalent' host, it then looks up the remote user's username 
in the local copy of letclpasswd. If it finds the username, the 
remote user is automatically logged in as if he or she were 
logging in on a terminal directly attached to the server’s host. 
A special type of entry in /etdhostsjequiv can be used to allow 
a remote user to autologin using a username other than his or 
her own. See hostsjeqmv(5) in the W1N/3B LAN Prognumiier’s 
Reference Manual for more details. 

If the incoming request is not coming from an equivalent host, 
rlogind looks for an account in letclpasswd that matches that 
used or specified by the requesting user. If such an account is 
found, the home directory associated with it is searched for a 
file named “Irhosts. If found, rlogind tries to find an entry in 
it that matches the requesting username and the requesting 
host. If such is found, the user is automatically logged in. If 
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all autologins arc unsuccessful, the user u prompted for 
username and password. See Scctioo 4.6 of thw manual for 
more information on "Irhost. 

3JS RWHO, RUPTIME, AND RWUOD 

The rwha command produces output similar to the UNIX tv/io 
command but displays the users of all hosts on the local 
network. If a user has not typed input to the system (or » 
minute or more, rwho reports this idle time. A user logged in 
but inactive for an hour or more is omitted from the. rwho 
report. 

The ruptime command displays the stc*us of all hosts cn the 
local area network. This command will print a table that 
contains the hostname, the current host status (up or dc’-zn), 
amount of time that the host has been up or down, the 
number of users on the host, and the load average IT 
includes all of the hosts on the local area network. The 
ruptime coutiiund normally sorts by hostname the list that it 
displays. 

rwhod is the server used by both rwho and ruptime and should 
be running on bothe hosts for complete information. This 
server is both a producer and consumer of information. As a 
producer, every two minutes rwhod sends a broadcast packet 
over the network. This packet contains load averages, a list of 
users and other information about the host on which it resides. 
This packet is read by the rwho daemons on the other 
networked hosts. Those daemons demonstrate the consumer 
side of the rwhod character. When one of them gets such a 
broadcast packet, it stores the information from the packet in 
a file in the directory lusrispool!rwho. A file is maintained in 
that directory for every host on the network. When a new 
host is configured into the network and its rwho daemon emits 
a broadcast packet, a receiving rwhod makes a new file for this 
host in lusrispool/rwho. 
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If rwhod does not receive t broadcast message from a remote 
host it assumes that host is down. Of course, if a remote host 
is listed its down, it is possible that only the rwhod is not 
running. To remove the ruptime entry of a host that has been 
permanently removed from a network, just delete the file on 
that host ;■» the lusrlspoollrwlio directory. 

3.6 RFMSil, RCP AND RSQD 

The remsh or 'remote shelT command enables a user to 
execute a command on a remote host, remsh passes 
INTERRUPT, QUIT and KILL signals to the remote host. 
Interactive commands, such as vi cannot be run using remsh. 
The connection normally terminates with the termination of 
the command. If no command is specified, the user is simply 
logged in. 

The rep command enables a user to transfer files between the 
local host and a remote host or between two remote hosts. 
Entries for both hosts must exist in the etc/hostsjequiv file for 
the transfer to be successful. It is essentially a special case of 
the more general renish and operates in much the same 
manner. 

rshd is the server for both remsh and rep. The rshd server 
attempts to validate and automatically login the user in the 
same way as riogind. If the autologin is successful and a shell is 
spawned, the shell inherits the opened connection. 

and, upon termination of the command, the shell and the 
connection die. 

3.7 REXEC, REXECD 

The rcxec function enables a program to execute commands on 
a remote host. This command differs from the rsh command 
in that it is invoked by a C program. If n username and 
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password are both specified, these are used to authenticate the 
user to the remote host. Otherwise the user’s juruc file on the 
local host is searched for the appropriate information, rexecd 
is the server for rexec. Once the user is authenticated on the 
remote host, the server spawns a shell, and this shell inherits 
the network connections established by the servcf. 

3J FINGER, FINGERD 

The finger command displays information about a user or 
users. It can also produce information about users on remote 
hosts, fingerd is the server for the finger command. This 
command operates in the same fashion on a remote host as it 
docs on the loccl host. 

3.9 /ETC/LDDRV/ETHERJtC 

When the system is booted and the network is brought up, 
addresses must be assigned to the network interfaces, and the 
daemons must be activated. This is accomplished through the 
shell script letcllddrvi ether sc. By default, this shell script 
starts the following networking daemons: 

ftpd 

tclnctd 

fingerd 

riogind 

rshd 

sendmail 

This file may also contain network-related booting tasks, such 
as setting upxoutes and assigning ^lecial network addresses. 
Network administrators will generally want to modify this file 
for their own sites. 
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4, NETWORK DATABASES 

Information about the hosts, networks, services and protocols 
is maintained in m set of network database files These files 
should be updated whenever the topology of the network 
changes. The procedures for changing the information in 
these files arc discussed in Section 6 of this document, 
'Configuration and Maintenance.* 

The names used for networks, hosts and host aliases must 
conform to some restrictions: 

1. The official hostname is the name of the host. This name 
is usually but not necessarily the same as that returned by 
the UNIX uname command. Sec hostname(l) in the 
WIN 3B LAN ProjTwnmer’i Reference Manotl for more 
information. 

2. Network and host names arc limited to 32 characters in 
length. 

3. Names must not contain any metacharacters: I ? f ) [ J • 3 / 

\ 

Generally aliases are shorter than the official names. A 
network can have several aliases. For more information on 
these files, see Section 5 of the WIN/3B LAN Progrmmiiier’f 
Reference ManoaJ. 

4.1 /ETC/HOSTS 

s 

letefhosts is an ASCII file containing the official hostnames, 
aliases, and Internet addresses of remote hosts. Networking 
applications programs reference this file to find the Internet 
addresses of hosts. On each line, the format is: Internet 
address, official hostname and aliases. These fields can be 
separated by spaces or tabs. The official hostname is the name 
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of the host. 

Each byte of the Internet addirets should be separated b> a 
period '.*. The aliases can be anything, and are usually an 
abbreviation of the official name. Comments mu.st begin with 
a pound sign '#*. 

# Local Hosts 

################################### 

8534.09.01 officalnamel aliasla aliaslb aliaslc 
8534.09.02 officaInBme2 alias2a 
8534.09.03 ofEcalnameS alias3a alias3b 

Figure 4-1. Example of !etc!hosts 

Both ftp and tetnet sequentially search this file for the Internet 
address of the host. It is good practice to put the most 
frequently used hosts at the beginning of this file to shorten 
search time. If there are two entries for one remote host, the 
first entry is used. This file can only be edited by the 
sup>cruscr. 

4.2 /ETC/NETWORKS 

letcinetworks lists the names, network numbers, and aliases of 
each network to which the current host has a direct 
connection. From this file IP determines which network a 
packet should be routed to. The format of the file is: official 
network name, network number and aliases. Fields are 
separated by blanks or tab characters. 

This file is supplied with distribution. You may need to 
update it for unofficial aliases and local changes. If your 
network will be connected to a larger network, for example 
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the ARPANET, your network name and number wUi be 
assigned to you. 

Loopback 127 loop Ib 

Ethernet 89 ether cnef 

Figure 4-2. Exfimplc o( ietc/networks 


Like letcihosts this file is searched sequentially, so for general 
efficiency place the most frequently accessed networks at the 
top of the file. 

43 /ETC/PROTOCOUS 

Utdprotocols is used by IP to determine which highei level 
protocol packets should be sent to. From the packet header, 
IP gets a protocol number, and finds the corresponding 
protocol using this table. 

Protocol names can contain any printable character other than 
a space, tab, newline or comment character. The format is: 
official protocol name, protocol number and any aliases. 
Comments are preceded with a pound sign 

# 

# Internet (IP) Protocols 

# 

ip 0 IP # Internet protocol, 

iemp 1 ICMP # inet control message protocol 

tep 6 TCP # transmisaon control protocol 

udp 17 UDP # user datagram protocol 

Figure 4-3. Example of !etc!protocols 
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4.4 /ETC/SERVICES 

fetdservices lists which transport protocol (TCP or UDP) and 
standard port number each user level service uses. 

The format of the file is: officnal service name, jxm 
number/protocol name and aliases of the services. The port 
number and protocol name are separated by a forward slash 
*/*'. New services can be added. 

# 

# Unix specific services 

# 

exec 512/tcp 

login 513/tcp log 

shell 514/tcp sh 

who 513/udp 

syslog 514/udp si 

talk 517/udp 

route 520/udp rte 

Figure 4-4. Example of fetc/servlces 
43 /ETC/HOSTS.EQUIV 

The letcihosts£qmv file is an optional file used by the servers 
rlogind and rshd to authenticate a request for login eoming 
from a user on a remote machine. It contains a list of remote 
or equivalent hosts. A user on a remote host with the same 
username can login automatically if the remote host is listed in 
this file. The system searches for the username in letclpasswd^ 
and if it finds it the user is logged in immediately. 

A special entry in this file specifies a username in addition to a 
host. This username must be a valid username on the local 
host. When someone docs a remote login specifying this 
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username, the user is automatically togged onto the system, 

rhostl 

rhost2 

rhost3 

rhost9 alfredo 
rhost33 wanda 

Figure 4-5. Example of letclhosts£qu\v 
"/.RHOSTS 

The 'Ishosts file is essentially a private version of 
letclhostsjtquiv and is used by the tame servers. This optional 
file is located in a user’s home directory. With it a user can 
permit his or her local account to be used by specific remote 
users on specific remote hosts for autologin to the local host. 
If a remote host is specified without a username, a user on the 
remote ho^t must have the same username as the owner of the 
local "Ijrhosts. Otherwise the user will be prompted for a login 
and a password. The format for 'hhosts is the same as for 
letdhosts jtqulv. 

4.7 /ETC/fTPUSER 

This file contains the names of those to whom ftp access is 
specifically denied. Every time an ftp user attempts to login, 
the ftp server searches this file for his or her username. If the 
name is found, the user is denied access. The following is an 
example of an ftpuser file. 


fred 

wilma 

barney 

betty 

dino 

Figure 4-6. Example of fetc/ftpusers 


Changes to letc/f tpusers must be made by the superuser. 

4JB V.NETRC 

The 'Ijietrc file contains information that enables a user to 
automatically login to a remote system as an /rp user. Located 
in a user’s home directory, this file lists a hostname and valid 
username and password for the remote hosts on which that 
user wishes to have autologin privileges. 

machine threeb2l login mpd password smurf 
machine threeb22 login mpd password fred 
machine threeb23 login mark password koala 

Figure 4-7. Example of jtetre 


Only the official hostnames, and not aliases, can be used in 
this file. If either "Inetre does not exist or it exists but 
contains no entry for the currently specified host, the user is 
prompted for username and password. Since this file contains 
sensitive information, ftp requires that it be owner-readable 
only. If it is not, an error message is printed and the user is 
prompted for username and password. If you do not want to 
include your password in this file, you can omit the password 
and the word 'password' on each line. When a user initiates 
an ftp connection, the system prompts for the password. 
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5. SOFTWARE INCTALLATION 

The installation of W1N/3B LAN k performed through the 
UNIX PC window interface. 

5.1 PREREQUISITES 

Installation requires the following: 

1. An Ethernet network interface board installed on your 
UNIX PC. 

2. The five WIN/3B LAN diskettes, which come in the 
WIN/3B LAN package. 

3. 2500 blocks (where each block b 512 bytes) available in 
the system. 

5J. INSTALLATION PROCEDURES 

1. Log in as install using the system console. 

2. When the Office of install menu appears, open the 
Administration window and open Software Setup. 

3. When the Software window opens, open Install Software 
f rom Floppy. 

The Confirm window opens containing prompts to guide 
you through the installation procedure. 

4. Insert the first floppy disk and press ENTER.. 

When prompted to do so. Insert the second floppy disk 
and press RETURN. 

5. Continue this procedure with floppy disks 3, 4 and 5. 
When the last disk has been read, you will see this screen. 
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Figure 5-1. Installation Confirm Screen 


6. Remove the floppy disk from the drive. 

When the Ethernet Setup window opens, answer the 
prompts by entering your network name and number, 
your host name and internet address, and any aliases for 
your host. The hostname should be the official name 
given by the UNIX uname ~n command. Finally, answer 
whether or not the driver should be loaded at boot time. 
Press ENTER. 
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Figure 5-2. Ethernet Setup Screen 

Names of hosts and networks must conform to the following 
restrictions: 

1. Each name is limited to 32 characters in length. 

2. Names must not contain any of the following characters: $ 

? { ) I 1 • !. 

The Internet address myst be unique, if you assi^ an address 
that already exists on your network, change your host name 
internet address entry in /ctc/hosts via Host Table 
Management to make it unique and select 'Configure Network 
Interface * 
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The network driver will be loaded to complete the xn5>«llation 
procedure, and a message will appear indicating that the 
installation is complete. Press ENTER to rciurr to the 
Software window. 

At this point, you might cheek to see if the Ltbetnet device 
driver has been installed by selecting ConfigsjJi Loadable 
Device Drivers. Look at the status of the Ethernet dnvet It 
should say 'Loaded*. 



Figure 5-3, Loadable Device Driver Interface Screen 


To customize your network, select Ethernet Setup in the 
Administration window. The utilities in the Ether-Set up 
window automatically edit the database files associated with 
WIN/3B LAN. These utilities arc described in the next 
chapter, 'CONFIGURATION ANP MAINTENANCE'. 
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53 VERIFICATION 

At this point, the network is installed and minimally 
configured. You will now be able to talk to yourself, but not 
to other hosts, since no other hcsis have yet been made known 
to your machine. However, befor.: proc^.fUng further it is a 
good idea to verify that the iiistailatloft configuration was 
performed correctly. The Ho.ft cmd Neiwork Tests option in 
the Ether-Setup window contains a sequence of five tests that 
exercise the installation. These tests are described in Chapter 
6. 'CONnOURATION AND MAINTENANCE'. Go through 
the tests described in Sections 6J.1 through 63.5. Successful 
passage will assure you that your network is installed properly- 
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6. CONFIGURATION AND MAINTENANCE 

Now that your WIN/3B LAN software has been loaded and 
tested, to be really useful it must be further configured with 
information about your network and other hosts accessible 
througli it. Configuration and maintenance are performed by 
the .<iupciU4cr on the system console from the WIN/3B LAN 
Ethcr-Sc(«ip window. To get to this window: 

1. Log in as Instmll. 

2. Open Administration 

3. Open Ethernet Setup 

All network configuration and maintenance can be 
performed from this window. All of these options first 
verify that the network has been initially set up 
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Figure 6-1. Ether-Setup Window 


The following sections describe each of the Ether-Setup 
options. The operations described under each option can 
also be performed manually using shell commands. To get 
to the shell, select UNIX System from the Office window. 
The UNIX System window opens showing the shell 
prompt 'r. Enter the appropriate shell command. Press 
< CTRL D> to return to the Office window. 

6.1 HOST AND NETWORK €X)NFlGURATION 

With the options in this window, you can 
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• add, delete, and display host table cntrie* 

• add, delete, and display network tnble entries 

• add, delete, and display routing table entries 

• add, delete, and display cquivalent-ho^t tabic entries 

• get, set, and delete Ethernet address* ri 

• configure network interfaces 

• start, stop, and show daemons 

• enable and disable daemons 

• start, stop, and show enabled daemons 

Select Host and Network Configuration to open the Ethcr- 
Config window. Each option in this window is described below. 
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Figure 6-2. Ethcr-Config Window 


6.1.1 Address Resolotlon Protocol MtiiageineiiC (erpbypaa) 


This option is used to get, set, or delete the Ethernet or 
Internet address of a known host from the Address Resolution 
Protocol (ARP) table resident in the kernel. This command 
only works if ARP is enabled. 

The translation of Internet to Ethernet address’ and vice 
versa, is generally handled automatically by ARP, but not all 
Ethernet drivers support ARP. To communicate with hosts 
using such drivers it is necessary to manually enter their 
Ethernet addresses in the ARP table. 


To get, set, or delete the Ethernet address of s host, select 
Address Resolution Protocol Managerrutni (arpbypass) to open the 
Address Resolution Protocol Management (arpbypass) window. 
The ARP Tabic Entry screen is used for the three aipbypass 
commands. Get, Set, and Delete, Select the appropriate 
command by pressing the <Cmd> key to open the ArpCom 
window; highlight the desired conunand. and press ENTER- 
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Figure 6-3. Selecting Commands from the ArpCom Window 


6.1.1.1 Get Ethernet Addrem 


To get an Ethernet address for a host, select Get from the 
ArpCom window. Enter cither the hostname or the Internet 
address, and press ENTER. The Internet and Ethernet 
addresses will appear in hex format next to the prompts. 
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Figure 6-4. Getting an Ethernet Address 


Notice that the Internet address is four bytes, and the 
Ethernet address is six bytes long. 

Sometimes this command produces the error: get: not In ARP 
table. Entries in the ARP table are volatile. lasting only 
twenty minutes. If you get this error, most likely the table 
entry for the host has been deleted. To make an entry in this 
table, simply attempt any network operation to this host and a 
new entry will be made in the table. 

6.1.U Set Ethernet Address 

If an Ethernet address is incorreet in the ARP table, first 
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delete the incorrect entry, then use this option to sri (he 
correct address. 

To set the Ethernet address of a host, select Se> lo the 
ArpCom window. The Address Resolution Protocol window 
opens showing the ARP Table Entr/ screen Answer the 
prompts by entering cither the hostname or Internet address 
and the Ethernet address, and press ENTER. The Internet and 
Ethernet addresses will appear in hex format when the process 
is complete. 



Figure 6-5. Setting an Ethernet Address 


You can perform this function manually from the shell using 
the arpbypass set command. 
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6.1.13 Delete Ethe'*ne( Addie^ 

To delete the Ethenjet address o( « host, select Delete from 
the ArpCom window. Enter either the hostname or Internet 
address, and press ENTER. The Internet and Ethernet 
addresses will appear in he* format when the process is 
complete. 



Figure <^6. Deleting an Ethernet Address 

You can perform this function manually from the shell using 
the arpbypass delete command. 
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6.13 EqnlTaleQt-HosC Table Manaipfcment 

This option is used to add or delete entries in the equivalent’ 
host table, and to display the contents of the table. Entries in 
the equivalent-host table allow users on a remote host to log in 
to the local host automatically, as lo g as the user’s username 
appears in the local host’s letcipasswd file. 

To add, delete, or display entries in the equivalent-host table, 
select Etpilvalens-Host Table Managemens to open the 
Equivalent-Host Table Management window. The Equivalent- 
Host Table Entry screen is used for the three equivdent-host 
table commands. Add, Delete, and Show. Select the appropriate 
command by pressing the CMD key to open the Commands 
window; highlight the desired command, and press ENTER. 

6.13.1 Add an Eqahralcnt-Hoft 

n 

To add an entry in the equivalent-host table, select Add in the 
Commands window. Enter the name of the remote host on 
which you have a login account, or press the CMD key to 
display a list of the current known hosts and select the host 
you wish to add. Press ENTER to add the equivalent-host to 
the equivalent-host table. 
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Figure 6-7. Adding an Entry to the Equivalent-Host Table 

The Confirm window will display a message confirming that 
the host database has been updated. Press ENTER to return to 
the Equivalent-Host Table Entry screen, or CANCL to return 
to the Ether-Config window. You will receive an error 
message if you try to add an equivalent host that already exists 
in the equivalent-host table. 

6.1JZJ1 Delete an Eqalrmlent-DiMt 

To delete an entry in the equivalent-host table, select Delete in 
the Commands window. Enter the name of the remote host 
you wish to delete from the table, or press the CMD key to 
display the remote hosts currently in the equivalent-host table 
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and select the host you wish to delete- Press ENTER to <ie;cte 
the host. 
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Figure 6-8. Deleting an Entry in the Equivalent-Host Table 

The Confirm window will display a message confirming that 
the host database has been updated. Press ENTER to return to 
the Equivalent-Host Table Entry screen, or CANCL to return 
to the Ether-Config window. You will receive an error 
message if you try to delete an equivalent host that does not 
exist in the equivalent-host table. 

6.U3 Show the Eqalvalent-Host Table 

To display the equivalent-host table, select Show in the 
Commands window and press ENTER. The Equivalent-host 
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database window openi showing the list of reroofe hosts and press ENTER- 

currently in the equivalent-host table. 

6.U.1 Add a Remote Host 



list of reaote Bachlnes which are equivalent 


Figure 6-9. Showing the Equivalent-Host Table 


6.1 J Host Table Management 

This option is used to add hosts to or delete hosts from the set 
of hosts known to your system, and to display the host table. 

To add or delete a host, or to display the host talble, select 
Host Table Management to open the Host Tabic Management 
window. The Host Table Entry screen is used for the three 
host tabic management commands. Add, Delete, and Show. 
Select the appropriate command by pressing the CMD key to 
open the Commands window; highlight the desired command. 


To add a remote host to the host table, sciccf Add ir> the 
Commands window. Answer the prompts by entering the 
official host name which must correspond to the output of the 
uname -n command, the Internet address, and any aliases for 
the new host. (See the section on Internet Addressing in thf 
first chapter for an explanation of the digits in the Internet 
address.) Press ENTER to add the host 
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Figure 6-10. Adding an Entry to the Host Table 
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The Confirm window will display a message coafinmng thak 
the host table has been updated. Prew ENTER to return to 
the Host Table Entry screen, or CANCL to return to the 
Ethcr-Config window. You will receive an error message if 
you try to add a host that already exists in the host table. 

This procedure adds the remote host to the /etcfhostr file. 


6.U J Delete a Remote Hort 


To delete a remote host from the set of hosts known to your 
system, select Delete in the Commands window. Enter the 
name and Internet address of the host to delete, or press the 
CMD key to display the list of known hosts and their Internet 
addresses and select the host you wish to delete. Press 
ENTER to delete the host from the host table. 
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Figure 6-11. Deleting an Entry in Host Table Entry 


The Confirm window will display a message confirming that 
the host table has been updated. Press ENTER to return to 
the Host Tabic Entry screen, or CANCL to return to the 
Ethcr-Config window. You will receive an error message if 
you try to delete a host that docs not exist in the host table. 


6.1.33 Showing the Host Table 


To display the list of remote hosts known to your system, 
select Show in the Commands window. Press ENTER to 
display the host table. The Host Table window opens showing 
the names and Internet addresses of all hosts currently known 
to your system. Selecting 'Show' will cause all hosts entered 
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via the User Agent to be displayed. U any hosts have been 
entered by editing /etc/hosts directly, they will not appear in 
user agent menus. Add them to the 
/usr/ethemct/ua/HostTable file. 
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Figure 6-12. Showing the Host Table 


6.1.4 Network Daemon Management 

This option is used to start, stop, enable, disable, ^od display 
network daemons. Select Network Daemon Management to open 
the Daemon Management window. The Daemon Management 
screen is used for all daemon management commands. Select 
the appropriate command by pressing the CMD key to open 
the Commands window; highlight the desired command, and 
press ENTER. By default the 'rwho', 'tftpd', 'rcxccd', and 
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Figure 6-13. Network Daemon Management Commands 


6.1.4.1 Show Daemons 

This command displays all currently running daemons. Select 
Show Daemons in the Commands window. Press ENTER to 
display the Ibt of currently running daemons. 
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Figure 6-14. Showing the Currently Running Daemons 


6.1.4^ Start Daemon 

To start a daemon, select Start Daemon in the Commands 
window- Enter the name of the daemon you wish to start, or 
press CMD to display a list of daemons and select the daemon 
you wish to start. Press ENTER to start the daemon. 
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Figure 6-15. Starting the sendmail Daemon 

The Confirm window will display a message confirming that 
the daemon has been started. Press ENTER to continue, or 
CANCL to return to the Ether-Config window. You will 
receive an error message if you try to start a daemon that does 
not exist or is already started. 

6.1.43 Stop Daemon 

To stop a daemon, select Stop Daemon in the Commands 
window. Enter the name of the daemon you wish to stop, or 
press CMD to display a list of daemons and highlight the 
daemon you wish to stop. Press ENTER to stop the daemon. 
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Figure 6-16. Stopping the sendmail Daemon 


The Confirm window will dt^lay a message confirming that 
the daemon has been stopped. Press ENTER to continue, or 
CANCL to return to the Ether-Config window. You will 
receive an error message if you try to stop a daemon that does 
not exist or is already stopped. 

6.1.4.4 Show Enabled Daemons 

To display the list of currently enabled daemons, select Show 
Enabled Daemons in the Commands window. Press ENTER to 
display the currently enabled daemons. 
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Figure 6-17. Showing the Currently Enr.blcd Daemons 


6.1.4.5 Enable Daemon 

To enable a daemon, select Enable Daemon in tbe Commands 
window. Enter the name of the daemon you wish to enable, or 
press the CMD key to display the list of daemons and select 
the daemon you wish to enable. Press ENTER to enable the 
daemon. 
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Figure 6-18. Enabling the tfpd Daemon 


The Confirm window will display a message confirming that 
the daemon has been enabled. Press ENTER to continue, or 
CANCL to return to the Ethcr-Config window. You will 
receive an error message if you try to enable a daemon that 
docs not exist or is already enabled. 

6.1.4.6 Disable Daemon 

To disable a daemon, select Disable Daemon in the Conunands 
window. Enter the name of the daemon you wish to disable, or 
press the CMD key to display the list of daemons and select 
the daemon you wish to disable. Press ENTER to disable the 
daemon. 
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Figure 6-19. Disabling the t/pd Daemon 


The Confirm window will display a message confirming that 
the daemon has been disabled. Press ENTER to continue, or 
CANCL to return to the Ethcr-Config window You will 
receive an error message if you try to disable a daemon that 
docs not exist or is already disabled. 

6.1.4.7 Stop All Running Daemons 

To stop all currently running daemons, select Stop Ali Running 
Daemons in the Conunands window. 
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Figure 6-20, Stepping All Running Daemons 


Figure 6-21. Starting All Enabled Daemons 


The Confirm window will display a message confirming that all 
network daemons have been stopped. Press ENTER to 
continue. 

6.1.4.8 Start Ail Enabled Daemons 

To start all enabled daemons, select Start All Enabled Daemons 
in the Commands window. 


The Confirm window will display a message confirming that all 
network daemons have been started. Press ENTER to 
continue. 

6.1JS Network Interface Configuration (Ifconfig) 

This option is used to manipulate or configure a network 
interface. It can also be used to enable or disable a network 
interface, or to toggle ARP or trailer processing by an 
interface. 

This option makes use of the ifconfig command which is 
invoked by letcllddrvletherre at boot time to bring up all 
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network interfaces. 

To configure an interface, select Network Interface 
Configuration (ifeon/ig) to open the Network Interface 
Configuration (ifeonfig) window. Enter the hostname or 
Internet address of your machine. Answer the next two 
prompts to enable or disable TRAILERS and ARP. Press 
ENTER 



Figure 6-22. Configuring Network Interfaecs 

The Internet addreas must be unique, if you assign an address 
that already exists on your network, ehange your host name 
internet address entry in /etc/hosts via Host Table 
Management to make it unique and scleet 'Configure Network 
Interface.' 
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6.13.1 EoablingfDisabling an interface 

The Netstat -I command shows which interfaces arc down by 
placing an astertsk next to the name of the driver. 
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Figure 6-23. Output of netstat 4 Command 

To turn the interface on, use ifeonfig with the 'up' parameter. 

#/Dsr/btn/lfconLflg enO op 

In some instances, you may wish to suspend a host from the 
network. There are a number of ways to accomplish this, but 
the quickuiit Is iu disable the interface to that network. 

#/iMr/bhiyIfeonfig enO down 

In this example the Ethernet driver is disabled, effectively 
suspending the host from the network. 

6.13.2 Enabllng/DInbUnf ARP 

ARP is normp.lly enabled when the network dnver is loaded by 
an entry in the letcllddrvlether j-c file. For instance, to enable 
ARP processing, run the following command: 

#/iur/bhi/ifcoiiflg enO arp 
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6,1,6 Network Table MUioatment 

This option is used to add and delete entries to the network 
table, and to display the list of currently known networks. 

To add or delete networks, or to display the currently known 
networks, select Network Table Management to open the 
Network Table Management window and show the Network 
Table Entry screen This screen is used for the three Network 
Table Management commands. Add, Delete, and Show. Select 
the appropriate command by pressing the CMD key to open 
the Commands window; highlight the desired command, and 
press ENTER- 

6.1.6.1 Add a Network 


To add a network to the list of known networks, select Add in 
the Commands window. Answer the prompts on the Network 
Table Ei;i'/ v : n; enter the name and network number of 
the new nctwoik. and any aliases. Press ENTER to add the 
network. 
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Figure 6-24, Adding a Network Table Entry 


The Confirm window will display a message confirming that 
the network database has been updated. Press ENTER to 
continue, or CANCL to return to the Ether-Config window. 
You will receive an error message if you try to add a network 
that already exists. 


6.1.6,2 Delete a Network 


To delete a network from the list of known networks, select 
Delete in the Commands window. Enter the name and 
network number of the network to delete, and press ENTER. 
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Enter netMork nuaber 


Figure 6-25. Deleting a Network Table Entry 


The Confirm window will di^lay a message confirming that 
the network database has been updated. Press ENTER to 
continue, or CANCL to return to the Ether-Config window. 
You will receive an error message if you try to delete a 
network that docs not exist. 

6.1.6.3 Show Known Networks 

To display the list of known networks, select Show in the 
Commands window, and press ENTER. The Network Table 
window opens displaying the list of networks and network 
numbers. 
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Figure 6-26. Showing the Network Table 


6.1.7 Route Table Management 

This option enables you to add a route entiTf to. delete an 
entry from, or display the network routing tables resident in 
the UNIX kernel. 

To add a route to or delete a route from the network, or 
display the route table, select Route Table Management to open 
the Route Table Management window. The Route Table 
Entry screen is used for the three route table management 
commands. Add, Delete, and Show, Select the appropriate 
command by pressing the CMD key to open the Commands 
window; highlight the desired command, and press ENTER. 
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Add • Rooting Table Entrir 

To add a route, select Add m the Commands window„ Answer 
the other prompts by entering the name of the destination host 
or network, the name of the gateway host, and whethc^r the 
destination is a network or host. Press ENTER, 
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Figure 6-27. Adding a Routing Table Entry 

The Confirm window will display a message confi^ng that 
the route table has been updated. Press ENTER to continue, 
or CANCL to return to the Ether-Config window. You will 
receive an error message if you try to add a route that already 
exists. 
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In the following example, these networks are interconnected 
via two gateways. 



Figure 6-28. Adding Routes - an Example 

Each gateway has two addresses, one for each network to 
which it's connected. Each network has a host which wishes 
to communicate with the hosts on the other networks. Shown 
in boxes are the commands the administrator of each host will 
need to enter to enable these hosts to communicate. Were this 
a regular requirement, these routing commands should be 
added to the network startup file tetdlddrvletherjrc 

6.1.7Delete a Rootlnf Table Entry 

This option enables you to delete a route from the network 
routing tables in the UNIX kernel. 
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To delete » route, select Delete m the Commands window. 
Enter the destination host or network name to delete, or press 
CMD to display the list of network routes and select the host 
or network name you wish to delete. Enter the gateway host 
name and whether the destination is a network or host. Press 
ENTER to delete the destination from the routing tables. 
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Figure 6-29. Deleting a Routing Table Entry 


The Confirm window will display a message confirming that 
the route table has been updated. Press ENTER to continue, 
or CANCL to return to the Ether-Config window. You will 
receive an error message if you try to delete a route that does 
not exist in the route table. 

You can manually delete a route using the route command. 
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6.1.73 Show the Routing Table 

To display the network routes,, select Shaw m the Commands 
window. Press ENTER to display the current network routes. 
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Figure 6-30. Showing the Routing Table 


63 HOST AND NETWORK INFORMATION 

The options in this window provide information about the 
local host's name, the status of various network-related data 
structures, and the hosts on the network. These options are 
used primarily to monitor and maintain your network. 
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€^.t L4»cal HostV Namr (hostname) 

This option prints the name of the current host. This is the 
official hostname reported by the UNIX command uname ~n. 
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Figure 6-31. Show the Local Host’s Name 


Network Status (netstat) 

1 

This option opens the NetStat window, which contains options 
for displa 3 ring the contents of various network-related data 
structures. It is the best source of information about the 
status of your network. 

Select Network Status (netstat) to open the NctStat window. 
Each option in this window is dcscrit^d in the sections below. 
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Figure 6-32. NctStat Window 


6.2 J.l Connections Co Remote Hosts 

This option displays the status of the active connections to 
remote hosts. Servers arc not shown. It displays network 
addresses symbolically, that is, by their associated names, 
rather than in Internet address format. 

The first column indicates the protocol associated with a given 
socket. The second and third columns indicate the current 
length of the socket queues. The fourth and fifth columns 
show the local and remote addresses of the connection with 
which the socket is associated. The sixth column shows the 
state of the connection. Note that ail the daemons are in the 
'listen* state and that their foreign addresses arc specified by 
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the shell wildcard 
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Figure 6-33. Connections to Remote Hosts 

6.2.2JI Local HosCs's Network Interfaces 

This option shows which media drivers, or network interfaces, 
are configured into the local host kernel. 
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Press EhTER to continue 


Figure 6-34. Local Host’s Network Interfaces 

The first column lists the name of the interface. The second 
column indicates the size in bytes of the maximum 
transmission unit for that interface. The third and fourth 
columns show the official names of the network and the host 
to which the interface is attached. The fifth through eighth 
columns list the number of incoming and outgoing packets 
over the last hour and their associated errors. The last column 
lists the number of Ethernet collisions detected. Collisions do 
not imply errors, since Ethernet employs a collision detectiem 
and recovery system. 

An asterisk after a value in the first column indicates that the 
interface has been disabled. A disabled interface can be 
enabled using the ifeonfig command from the shell. 
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You can also perform this function from the shcli by executing 
the ruftstat -i command. 

Network Memory Management Statistics 

This option lists statistics produced by memory management 
routines with which the network manages its own private 
share of kernel memory. It allocates and frees parcels of that 
memory in units called 'mbufs'. An mbuf is ordinarily 12S 
bytes. When messages of more than 128 bytes are formed, 
mbufs are chained until enough memory is supplied. When 
messages exceed 1024 bytes, memory may be allocated in *click 
mbufs," which arc 1024 bytes in length. 
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Figure 6-35. Network Memory Management Statistics 
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You can also perform thU function from the sheU executing 
the netstat -m command. 

6.2 J1.4 Protocol Error Statistics (ICMP) 

The Protocol Error Statistics options display error statistics for 
each protocol. This option displays error statistics for the 
ICMP protocol. 
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Figure 6-36. Protocol Error Statistics for ICMP 

You can also perform this funcition from the shell by executing 
the netstat -s -p iemp command. 
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Protocol Error Suttsticv (IP) 

The Protocol Error Statistics options display citot statistics for 
each protocol. This option displays error statistics for the IP 
protocol. 
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Figure 6-37. Protocol Error Statistics for IP 


You can also perform this function from the shell by executing 
the netstat -s -p Ip command. 

Protocol Error SUtlstlcs (TCP) 

The Protocol Error Statistics options display error statistics for 
each protocol. This option displays error statistics for the TCP 
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protocol. TCP has built in crroi detection and correction for 
reliability; any errors recorded here have been corrected, and 
should cause no concern. 


nwigwinm 

NetStat 


Had Hay 2B, 2:44 pa 

TTHuif; 


Connections to Reaote Hosts 
Local Hosts's (letMork Interfaces 
HetHork Henory Hanageaent Statistics 
Protocol Error Statistics (TCHP) 
Protocol Error Statistics (IP) 

am wi WBaiia^i mtiata a 

Protocol Error Statistics(HOP) 
Routing Statistics 

Routing Table_ 


j st's Haae (hostn aae) 
lun Hosts (vieuhosLs) 



0 bad header checkiuas 
0 bad header offset fields 
0 incoaplete headers 



Press EMTER to continue 


Figure 6-38. Protocol Error Statistics for TCP 

You can also perform this function from the shell by executing 
the netstat -s -p tep command. 

6 J.2.7 Protocol Error SUtlstlcs (UDP) 

The Protocol Error Statistics option displays error statistics for 
each protocol. This option displays error statistics for the 
UDP protocol. 
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Press iMTER to continue 


Figure 6-39. Displaying Protocol Error Statistics for UDP 


You can also perform this function from the shell by executing 
the netstat ~s -p udp command. 

6 Rooting Statistics 

This option displays routing error statistics. Look here if your 
system performance is poor. If lots of errors are repdrted here, 
the poor performance is probably caused by the time^ 
consuming retransmits caused by the errors. 
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Connections to Reeote Hosts 
Local Hosts's HetMork Interfaces 
Network Meeory Hanageaent Statistics 
Protocol Error Statistics (ICHP) 
Protocol Error Statistics (IP) 
Protocol Error Statistics (TCP) 
Protocol Error Statistics (UDP) 
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Figure 6-40. Displaying the Routing Statistics 


You can also perform this function from the shell by executing 
the netstat ~rs command. 

6.2.2.9 Routing Table 

This option displays the the Internet Protocol routing tabic. 
This table lists the available routes and their status. Each 
route consists of a destination host and a known gateway to 
that host. 
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Figure 6-41, Displaying the Routing Table 

The first column shows the name of a desired destination for a 
packet. The second column lists the appropriate gateway. The 
third column indicates whether the gateway is up or down. 
An 'H* in this column indicates that the destination is a host; 
a 'G* indicates that the destination is a gateway. The fourth 
column shows the number of times the route has been used in 
the last hour. The fifth column shows the number of packets 
that have been routed through this gateway within the last 
hour. The last column indicates the interface used for the 
network. 

You can perform this function from the shell by executing the 
netstat -r command. 
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This command provides a qmcV way of dcicnninin^ which 
networks are up and which interfaces these networks use. 
This table is normally updated manually with the wouie 
command. It can also be maintained by the rnuKed daemou 

6JS.2.10 State of All Sockets 

This option shows the state of all sockets, those used by 
servers and those occupied by the network daemons 
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Figure 6-42. Displaying the State of All Sockets 

The first column indicates the protocol associated with a given 
socket. The second and third columns indicate the current 
length of the socket queues. The fourth and fifth columns 
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show the local and remote addresses of the connection with 
which the socket is associated- The sixth column shows the 
state of the connection. Note that all the daemons arc in the 
'listen* state and that their foreign addresses arc specified by 
the shell wildcard character 

Show Known Hosts (viewhosts) 

This option displays the contents of the letcihosts file. 

To display a list of the hosts on your network, select Show 
Known Hosts (viewhosts). The Host Table window opens 
showing the host names and Internet addresses of the current 
known hosts. If there arc many known hosts, the table may 
appear in two columns. 



Figure 6-43. Displaying the Known Hosts 
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€3 HOST AND NETWORK TESTS 

The sequence of tests contained in this window arc intended 
for use after installing the network or when some sort of 
network failure seems to have occurred- Each test exercises a 
different feature of the network. The sequence is divided into 
three groups. The first, consisting of one test, determine* 
whether the network driver is loaded or not. The second, 
consisting of three tests, exercises different protocob in the 
loaded network driver, as well as the pseudo terminal driver. 
The third, with one test, accesses both the Ethernet software 
and the hardware. 

While the tests are alphabetized in the window, they should be 
performed in the order presented below. By performing the 
tests in the following sequence, you will be able to verify the 
correct or incorrect functioning of these different network 
features. 

63.1 Test for Driver (Iddrv) 

This test simply checks the status of the network driver. 
Results resembling those shown below indicate that the driver 
is loaded. If the flags ALLCK^ and BOUND are not shown, 
the driver is not ready for operation. Ordinarily this will 
never happen unless the driver has been intentionally 
unloaded. To reload the driver, select Software Setup in the 
Administration window. Load the driver with the Corfigure 
Loadable Device Drivers option and rerun this test. If it passes 
then select [Start-up Ethernet on thb Host] under the [Start¬ 
up or Shutdown] entry in the [Ethernet Setup] menu. 
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Figure 6-44. Testing the Network Driver 


6 J J Local Teat with TCP (finger) 

This and the other two 'local' tests exercise the network 
driver without accessing the Ethernet hardware. This test 
particularly exercises TCP using finger to do a loopback test. 
Results resembling those below indicate that the TCP protocol 
is functioning properly. 


Figure 6-45. Testing with TCP 


€33 Local Test with UDP (tftp) 

This local test exercises the UDP portion of the network 
driver using tftp for a loopback connection. Receiving the 
tftp> prompt indicates that you arc running the tftp command 
interpreter. To verify that UDP is functioning properly, 
execute one of the tftp command 'get' or 'put'. The tftp 
daemon must be, running for this test to complete successfully 
When the transfer has been completed, exit tftp by entering 
'quit', then close the window by pressing ENTER. 
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Figure 6-^. Testing with UDP 


63,4 Local Teat with Pseudo TTY (Ccinet) 

In addition to TCP, this test also exercises the pseudo terminal 
portion of the network driver using tetnet to perform a 
loopback test. Appearance of the login prompt indicates that 
this portion of the driver is functioning properly. Type quit to 
exit the test. 
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Figure 6-47. Testing with Pseudo TTY 


633 Remote Test (finger) 

With this test you utilize the Ethernet software and hardware 
using finger to display the users on a remote host. Exit the test 
window by pressing < Enter>. If all these tests have been 
passed, you should have no difficulty using your network. 


89 












WrN/3B L 


ADMINISTRATOR'^ GUIDE 



Press tHTER to continue 


Figure 6*48. Remote Test of the Ethernet Software and Hardware 


6.4 STARTUP OR SHUTDOWN 

‘This option starts or stops all daemons and starts up or shuts 
down Ethernet on the local host. 

6.4.1 Shutdown Ethernet 

To shut down Ethernet, select Startup or Shutdown to open the 
Start-Stop window. Select Shutdown Ethernet on This Host 
(netshut). The Confirm window opens with the following 
message. 
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Figure 6-49. Shutting Down Ethernet 


Press ENTER to continue and shutdown the Ethernet 
daemons. The Confirm window will open again asking if you 
wish to unload the Ethernet driver. Press ENTER if you wish 
to unload the Ethernet driver, otherwise press CANCL, 

6.4Startup Ethernet 

To start up Ethernet, select Startup or Shutdown to open the 
Start-Stop window. Select Startup Ethernet on This Host 
(netstart). The Confirm window opens with the following 
message: 
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Figure 6-50. Starting Up Ethernet 
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7. SOFTWARE DEINSTALLATION 

In some cases, such as when new releases of WIN/3B LAN are 
issued, it will be desirable to entirely deinstall WIN^3B LAN. 
Deinstalling stops all network rclatcd running processes and 
removes all network software from the disk. The Remove 
Installed Software option removes all files assoaated with 
WIN/3B LAN. All other files arc left undisturbed. 

To deinstall the WIN/3B LAN files, open the Administration 
window and select Software Setup. When the Software 
window opens, select Remove Installed Software. The Software 
window opens showing the currently installed software Select 
Ethernet (WIN/3B LAN) Press ENTER to deinstall the 
Ethernet software. 



Hove pointer to package you want deleted and press Enter. 


Figure 7-1. Deinstalling Ethernet 
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The deinstall procedure first stops ail daemons associated with 
WIN/3B LAN and then removes all files installed with WIN/3B 
LAN. 

When the deinstallation is complete, a window appears with ♦ 
message declaring that the Ethernet software has been 
removed. Press ENTER to return to the Software window. 


8, NETWORK ERRORS 

This chapter contains lists of most of the error messages 
associated with WrN/3B LAN. Ncsi to them arc possible 
causes and solutions. It is organized into five sections based on 
the probable message source. Within each section the errors 
arc organized alphabetically according to the tcjct of the error. 


8.1 SYSTEM ERRORS 


These occur when an improper operation occurs at the kernel 
level. They arc produced by the lower level protocols. Many 
of these will be seen only by those in the process of developing 
new network applications with the SCI or TLI librarics. 

Addren already In oae 

Addresses must be unique to each host and 
arc permitted to be used only once. 

Address family not supported by protocol family 

An address incompatible with the requested 
protocol was used. 

Bad protocol option 

A bad option was specified in a getsockopt or 
setiockopt call. 

Can’t assign requested address 

This normally results from an attempt to bind 
a socket to an illegal address or to one already 
in use. 

Can’t send after socket shutdown 

A request to send data was disallowed because 
the socket had already been shut down with a 
previous shutdown call. 
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ConocctioD reset by peer 

A connection was forcibly dosed by « peer. 
This normally results from the peer executing 
a shutdown call. 

Connection timed out 

A connect request failed because the 
connected party did not properly respond 
after a spedfled period of time. This could 
indicate that the remote host is down. 

Connection refused 

No connection could be made because the 
remote host actively refused it. This usually 
results from trying to connect to a service that 
is inactive on the foreign host. 

control block: symbol not In namelist 

This error indicates a problem with the kernel 
symbol tabic. Contact AT&T Technical 
Support. 

Destination address required 

A required address was omitted from an 
operation on a socket. 

Message too long 

A message sent on a socket was larger than 
the internal message buffer. 

Network dropped connection on reset 

The host you were connected to crashed and 
rebooted. 

Network Is down 

A socket operation encountered a dead 
network. 

Network Is onreachable 

A socket operation was attempted on an 
unreachable network. 
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No buffer space available 

An operation on a socket or pipe was not 
performed because the system lacked 
sufficient buffer space. 

Operation already In progress 

An operation was attempted on a non* 
blocking object that already had an operation 
in progress. 

Operation now In progresa 

An operation was attempted that takes « long 
time to complete (such as a connect). 

Operation would block 

A blocking operation was attempted upon an 
object in the non-blocking mode. 

Socket Is already connected 

A connect request was made on an already 
connected socket or a sendto or sendmsg 
request made on a connected socket specified 
a destination other than the connected party. 

Socket Is not connected 

A request to send data was disallowed because 
the socket had already been shut down with » 
previous shutdown call. 

Socket operation on non-socket 

A socket operation was attempted on a non¬ 
socket device. 

Socket type not supported 

Support for the spedfled socket type has not 
been configured into the system or no 
implementation for it exists. 

Software caused connection abort 

A connection was aborted by the local host. 
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8 J FTP AND TTIT ERRORS 


Already connected to hostname, ofc disconnect first 

You arc currently connected ito remote host 
hostname, even though you may not be logged 
on. Either log in or disconnect and try again. 

bad port nomber 

A zero or negative port number was specified 
by the user with the port option on the open 
command. 

can’t find list of remote flics, oops 

When invoking a multiple command, a 
temporary file is created in the ftmp directory. 
The system cannot find this file, or it was 
accidentally removed. Try the procedure 
again. 

filename not a plain file 

A directory or some q)ecial device was 
specified for a transfer operation when only a 
file was appropriate. 

ftp/tep: unknown service 

The ietc/services file docs not contain an entry 
for the specified ftp service. An entry for this 
service should be created in this file. Sec 
services(5) in the WIN/3B LAN Proframmer’s 
Reference Mannal. 

Login failed 

The user gave an invalid username or 
password. Try again. 

Lost connection 

The server on the remote host closed the 
connection. This could be caused by many 
different things, including the remote system 
crashing, automatic logout, etc. 
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No port available for data connection 

This is an unlikely error. It could indicate 
software problems. Contact A TAT Technical 
Support, 

No target machine specified 

This error b associated with tftp when s file 
transfer is invoked without specifying a 
remote machine. Do an open before invoking 
the transfer command. 

Not connected 

You attempted to use an ftp command 
requiring a connection before you established 
the connection. Do a connect before invoking 
the transfer command. 

Unknown host 

The hostname given is not in the Jetc/hosts file. 
Verify the hostname and try again. 

User already logged In 

A user who is already logged into a remote 
host attempted to login again. 

We only support non-print format, aorry 

Currently ftp only supports the 'non-print' 
format. 

We only support file stmetnre, sorry 

Currently ftp only supports the 'file' 
structure. 

unknown mode 

Attempted to set a mode that b not 
supported. Currently, the supported modes 
are binary, ASCII and tenex. 

?Amblgnoos command 

Invoked an abbreviated ftp command that was 
not unique. Be sure to specify enough of the 
command to make it unique. 
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?Amblsaoat help commiUMS command 

The command specified for the help command 
was not unique- Be sure to specify enough to 
make it unique. 

Tlnralld eommand 

Invoked an unknown command. For a 
complete list of valid commands, type help. 

?lnvaUd help command command 

Invoked the help command with an invalid 
command name. For a complete list of valid 
commands, type help. 
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TELNET ERRORS 


bad port nomber 

A zero or negative port number specified by 
the user with the port option on the open 
command. 

Connection closed by foreign host 

A connection was forcibly closed by a peer. 
This normally results from the peer executing 
a shutdown call, although it may also indicate 
that the remote host has crashed. 

no open connection to negotiate options 

You must be connected to a remote host 
before you can negotiate options. 

telnet: tcp/telnet: nnknown service 

The tetc/servlces file docs not contain an entry 
for the telnet service- An entry for this 
service should be created in this file. See 
servlces(5) in the WIN/3B LAN Programmer's 
Reference Manual. 

unknown host 

The hostname given is not in the fetcihosts 
table or a hostname was specified incorrectly. 
Sec winSbaddhosts in the WIN/3B LAN 
Ethernet Administration menu. 

TAlrcady connected Co hostname 

You attempted to establish a connection with 
a remote host to which you are already 
connected. 

fAmblguoos command 

You invoked an abbreviated telnet command 
that was not unique. Be sure to specify 
enough of the command to make it unique. 
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TAmblsnoti# help coounAntd comrTux‘x>-t 

Tl»c command speciftrxji tm the help command 
waa not unique. Be *urc to specify enough to 
make it unique. 

?LciTaild command 

Invoked an unknown command. Fof a 
complete list of valid commands, type furlp. 

Tlnvalld help command command 

Invoked the help command with in invalid 
command name. For • complete list of valid 
commands, type help. 

8.4 REMOTE COMMAND ERRORS 


Bad arhosti ownership 

"/j-hosts must be owned by the current user. 
Its ownership is determine! to be the owner 
of the home directory in which the file 
resides. 

Host name for yoar address nnknowo 

The name of your host is not in fetefhosts on 
the remote host. 

Login Incorrect 

An invalid username or password was 
specified. Try again. 

Login timed oot after x seconds 

The user did not login within the required 
time, so the login procedure exited. 

metre file not correct mode. Remove password or correct 
mode' 

The Metre file should only be readable by the 
owner. No other protection mode is allowed 
due to the sensitivity of the information this 
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file contains 

No directory! 

There is no home direcion! aT^icoCied in the 
ietc/passwd file for the use/ logging uUo » 
remote host 

No shell 

There is no shell speafied in fetc/passwd file 
for a user logging into a remote host. 

rep: who are yon? 

rep attempted to ascertain tbe username of 
the user but failed. 

rep: Invalid user name 

There is no such user on the remote host. 

rep: lost connection 

During a remote copy, the remote host closed 
the connection. Possibly the remote host 
crashed. 

too many hosts 

The ruptime command can print information 
on a limited number of hosts, (about 100) If 
the number of hosts on a network exceeds this 
amount, ruptime produces this error. 

no hosts!?! 

This error occurs when the ruptime command 
is invoked and there is no information on any 
hosts in the /usrfspool/rwho directory. Most 
likely rwhod is not running. 

rwho too many osert 

The rwho command can print information on 
a maximum of about 1000 users. If the 
number of users on a network exceeds this 
amount, the rwho produces this error. 
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j-hofta b a soft link 

'Ijhosta file cannot be a link. 

Unknown Jietrc option 

"Ijtetrc contains illegal information. See 
netrciS) of the WIN/3B LAN Programmer*! 
Reference Manual. 

unknown service 

The letciservicea file does not contain an entry 
for this command. An entry for this service 
should be created in thu file. See services(5) 
in the W1N/3B LAN Programmer’s Reference 
Manual. 

Yon have too many proceases mnnlng 

There are too many processes running on the 
remote host for one user. 

SS ADMINISTRATIVE COMMAND ERRORS 


arpbypass must have SYSPRV 

You must be a superuser in order to run the 
arpbypass command. 

no Interface for Internet address 

No interface has been defined yet for the 
specified Internet address. See if config(IM) in 
the W1N/3B LAN Programmer's Reference 
Manual. 

No room In ARP table, try later 

Attempting an arpbypass command^ the ARP 
table currently is full. Delete unwanted ARP 
entries with the arpbypass(IM) command. 
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Warning does not match ntsnamea 

This message is produced when you attempt ifo 
set the hostname to something other than the 
current UNIX system name. 
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APPENDIX A: HARDWARE INSTALLATION 

[Installation of Ethernet software and expansion board is also 
described in the ATAT UNIX PC Ethernet Boaid Installation 
and Diagnostic Guide.] 


APPENDIX B: SAMPLE SCENARIOS 

TTiis appendix gives three examples of problems that could 
arise with WIN/3B LAN. The purpose of this section is to 
demonstrate the network debugging process. 

The examples in this section are performed trom the shell 
You can perform the same examples u.dng the menu interface 


SCENARIO 1 


When attempting to/tp a file from a remote host to the local 
UNIX PC, the system responds with the error message 
connection refused. 

#ftp 3b2 

ftp: connect: connection refused 
ftp> 

This indicates that the ftpd daemon on the remote host had 
trouble establishing the requested connection. If other 
WIN/3B LAN commands do not work, there may be a problem 
with the kernel level networking software on the remote host. 

Log on as root to the remote host. The first thing to check is 
whether the remote ftp daemon was running by using netstat 
-a:. 


#neUtat >• 

Active connections (including servers) 


Proto 

Reev-O 

Send-Q 

Local AddrcM 

Foreign Addreia 

(state) 

tep 

0 

0 

*jhell 


LISTEN 

tep 

0 

0 

*iogin 

• • 

LISTEN 

tep 

0 

0 

*jHnger 

• • 

LISTEN 

tep 

0 

0 

•.telnet 

• • 

LISTEN 
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Log off the remote host and log back onto the local ho»t„ 
Since there is no listing for /f/xf, it is not running. To 
reactivate this daemon, simply type the command 
tusr tether netidaemonsif tpd. 

#/osr/ethemeC/daemoii/rtpd 


Try the ftp command again: 

#rtp 3b2 

Connection Opened 
Using 8-bit bytes. 

< 3b2 comk FTP server 
(Version 4.1 Wed Jun 26 0138:17 PDT 1985) 
TWO VAX FTP User Process (Version 3 jOO) 


SCENARIO 2 

When attempting to make a loopback connection with telnet. 
the system responds with this error message: 

#teliiet 3b2 

Trying... 

telnet: connect: Network is unreachable 
telnet> quit 
# 

Again, And out whether the telnet daemon is down using netstat 
-a. 

#netstat -a 


Active connections (including servers) 


Proto 

Reev-O 

Seod-O 

Local Addreas 

Foreign Addrea 

(•late) 

tep 

0 

0 

3b2.teloe( 

q>erTypcS233 

ESTABLISHED 

tep 

0 

0 

*abeU 

• • 

LISTEN 

(cp 

0 

0 

•login 

• • 

LISTEN 

tep 

0 

0 

•jBnger 

• • 

LISTEN 

tep 

0 

0 

•ieloef 

• « 

LISTEN 


AH the servers, including telnet are up and a telnet between 
the local host and a remote host is currently active. Possibly 
there is a problem with the loopback interface. Using the 
netstat -i command, check the interface, 

#netstat -I 

Name Mtu Network Addrem Ipktt terra Opkta Oem CoUit 

enO 1500 Peg twgvax 3349 0 3S6 0 0 

ioO* 1536 Loopback 3b2 0 0 0 0 0 

The asterisk indicates that the loopback interface is down. To 
bring this interface back up use the ifconflg command. 
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#lfcoiiftt loO ap 


#neUtmt -I 


Name 

Mra 

Netwoik 

Addrcaa 

Ipktif 

terra 

Opkta 

Ocirrs 

ColUi^ 

eoO 

1»0 

Pti 

twjva. 

334W 

0 

386 

0 

e- 

(oO 

1536 

Loopback 

3b2 

0 

0 

0 

0 

0? 


The Icx)pback interface is now up. The Koopback mode shouid 
now function properly. 


SCENARIO 3 

None of the networking operations recognize the retnutc b-isis. 

#telnet 3b5 

3b5: unknown host 

#rtp 3b20 

3b20; unknown host 


First make certain that the interface for the network is up. 
Again use the netstat -i command. 

#netstat -I 


Name 

Mtu 

Network 

Addrew 

Ipkta 

terra 

Opkta 

Oeria 

CoIUa 

eoO 

1500 

Peg 

fwgvw 

3349 

0 

386 

0 

0 

loO 

1536 

Loopback 

3b2 

0 

0 

0 

0 

0 


All of the interfaces are up, possibly there is a problem with 
the fete/hosts filc. 

#more /ctc/hosts 

/etc/hosts: no such file or directory. 


The (etcihosts file is missing! Without this file, none of the 
network commands will work. 

For some reason, this file has been deleted or removed. Look 
for it first in the standard UNIX directory llostd/ound. If you 
do not find it, you will have to either recreate it or restore it 
from a backup copy. The format for this file is listed in Section 
5 of the WIN/3B LAN Progranutner'a Reference Manoal. 
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APPENDIX C: RECOMMENDED READING 

For information about networking in general, the following 
selections are recommended: 

E5 Brooncr, Ttu Local Area Network Booky Howard Sams A 
Co., Inc. Indianapolis. IN. 1984. This book serves as an 
excellent introduction to local area networking. It is written 
for readers with minimal technical background. 

JH. Green, Local Area Networks, Scott. Foresman and 
Company, Glenview, DL, 1985. Green’s book discusses 
networking from the perspective of the business professional. 

A.S. Tannenbaum, Computer Networks, Prentice-Hall, 
Englewood Cliffs, NJ, 1981. This it possibly the best text book 
for computer networks. Tannenbaum discusses all aspects of 
computer networking in a straight-forward, readable style. 

A.S. Tannenbaum, 'Network Protocols,' ACM Computing 
Surveys, Volume 13, Number 4, December 1981. This excellent 
article addresses in a broad yet detailed fashion the use of 
protocols in networking and different network architectures. 
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